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PREFACE 

This document describes the source file components which make up the 
version 3 PDP-15 Disk Operating System, DOS-15 V3A, and explains the 
steps which must be taken to assemble a binary from the source and 
to incorporate it into an existing DOS-15 V3A system. 

To follow the steps outlined in this document the reader should be 
familiar with the following utility programs: 



Program 
DOSSAV 
MACRO- 15 

MACRO- 11 

PATCH 
PIP 

SGEN 
UPDATE 



As Described in Manual 

DOS User's Manual, DEC-15-0DUMi\-B-D 

MACRO 15 Assembler Programmer's Reference 
Manual, DEC-15-LMACA-B-D 

MACll Assembler Programmer's Reference 
Manual, DEC-15-LMCMA-A-D 

PATCH Utility Program, DEC-15-UPATA-A-D 

PIP DOS Monitor Utility Program, 
DEC-15-UPIPA-A-D 

SGEN-DOS Utility Program, DEC-15-USGNA-A-D 

UPDATE Utility Program, DEC-15~YWZB-DN7 



IV 



INTRODUCTION 

Source files for DOS-15 V3A are available on DECtapes or 7 or 9 
track magtape. The steps required for each source are listed either 
in Table 1, Table 2, or Table 3, 

The first step of assembling, in some cases, is to rename the file 
prior to assembly. This is not a necessity but in this document it 
simplifies the explanation of command strings required to install 
the assembled binaries. However, the user can perform the renaming 
process after assembly or, when making binary input to the PATCH 
utility program, forego renaming altogether. 

The second step is to assemble the source using the proper assembler. 
Most of the sources are assembled using the MACRO-15 assembler (Table 1) 
A few are assembled using MACRO- 11 (Table 2) . Some are to remain as 
source files and others are to be compiled by FORTRAN (Table 3) . 

There are two programs which cannot be assembled by the user under 
DOS-15: they are the sources which make up the PDP-11 code for the 
MACRO-11 assembler and the source for the ABSLll paper tape loader. 
This is explained in the notes. 

Some source files are conditionally coded to produce several different 
binaries based either on the existence or nonexistence of definitions 
for given symbols or on their defined values. 

The type of binary produced by the assemblers will vary. For 
MACRO-15 output in Table 1 there is a column which shows either BIN 
(relocatable binary) , ABS (absolute binary) or HRM (hardware readin 
mode) . BIN and ABS files can be produced on a directoried device 
such as disk. HRM files must be assembled directly onto paper tape. 

It is standard practice with MACRO-15 BIN files to shorten them 
by using the UPDATE utility program with the S option. 

In Table 2, output from the MACll assembler is listed as OBJ which 
means OBJECT MODULE. Object modules are converted to load modules 
by a linker. Load modules and object modules are provided as 
absolute binary code on paper tape. 



Table 1 
Sources Assembled Under MACRO- 15 



Source File 




Rename 


It 


Desired 


Assembly 


Type of 


Footnote 


Name 




To 




Version 


Parameters 


Binary 




ABSLll 


014 


- 




- 


- 


HRM 


10 


CD. DOS 


031 


CDB. 


0^31 


CR^3B*/)^29** 


- 


BIN 


1 






CDB. 


^31 


CR03B/j2(26 


DECja26=0 


BIN 


1 






CDB. 


/31 


CRl5/^29 


CR15=/ 


BIN 


1 






CDB. 
CDB. 


jzf31 
^31 


CRl5/jZ(26 

CR^1E/CR^2B 
)^29 


CRl5=p' 

DECj2f26=^ 

NOTGDI=0 


BIN 
BIN 


1 

1 






CDB. 


jZf31 


CR01E/CR^2B 
^26 


NOTGDI=0' 
DECp^26=jZf 


BIN 


1 






CDB. 


jZf31 


CRll/j/29 
Spooled*** 


UC15=J2f 


BIN 


1 






CDB. 


j^31 


CR11//26 
Spooled*** 


UC15=0' 
DEC^26=J^ 


BIN 


1 






CDB. 


^31 


CRll/p'29 
Unspooled*** 


UC15=/ 
NOSPL=jZf 


BIN 


1 






CDB. 


)Z531 


CRll/j2f26 
Unspooled*** 


UC15=)2S' 

DEC^26=jef 

NOSPL=;? 


BIN 


1 


CHAIN 


154 


- 




- 


- 


ABS 


2 


CREF 


P<^ 


- 




- 


- 


ABS 


2 


DDT 


012 


- 




PAGE MODE 


- 


BIN 


4 










BANK MODE 


PDP9=0^ 


BIN 


4 


DOSBCD 


005 


BCDB. 


005 


All Versions 
CR03B*/029** 


BCDSTA=xxxxx 

BCDADR=yyyyy 


ABS 


12 
6,12 






BCDB. 


9!9i^ 


CR03B/;Z}26 


DEC026=0 


ABS 


6,12 






BCDB. 


0J3 5 


CR01E/CR^2B 
J329 


NOTGDI=0 


ABS 


6,12 






BCDB. 


gifK5 


CRO1E/CR02B 
J?26 


NOTGDI=0 
DECpf26=0 


ABS 


6,12 


DTA. 


jZi23 


- 




- 


- 


BIN 


1 


DOSNRM 


074 


DOS 15 


074 


NO UC15 


- 


BIN 


5 










HAVE UC15 


UC15={2f 


BIN 


5 



*Type of controller. 
**Type of card code. 

***Spooled and unspooled refer to how the device is handled when the UNICHANNEL-15 
spooler is turned on. 



Sources 



Table 1 (Cont.) 
Assembled Under MACRO-15 



Source File 




Rename 


It 


Desired 


Assembly 


Type of 


Footnote 


Name 




To 




Version 


Parameters 


Binary 




DOSPIP 


103 


PIP 


i;Zf3 


- 




BIN 


5 


DOSRFA 


140 


OKA. 


140 


DKA. 


- 


BIN 


1 






DKB. 


140 


DKB. 


%BVERS=iZf' 


BIN 


1 






DKC. 


140 


DKC. 


%CVERS=;ZJ 


BIN 


1 






DKL. 


140 


DKL. 


%LVERS=0 


ABS 


6 






RKA. 


140 


RKA, 


%RKj^5=0' 
%RP)d2=^J 


BIN 


1 






RKB. 


140 


RKB. 


%RK(^5=j2r 
%RP0'2=0' 
%BVERS=0 


BIN 


1 






RKC. 


140 


RKC. 


%RK^5=;2f 
%RP^2=J0 
%CVERS=;e^ 


BIN 


1 






RKL. 


140 


RKL. 


%RKj2r5=J2r 
%RPJZf2=^ 
%LVERS=J2^ 


MS 


6 






DPA. 


140 


DPA. 


%Rpjzf2=;zr 


BIN 


1 






DPB. 


140 


DPB. 


%RP/2=jef 
%BVERS=J0 


BIN 


1 






DPC. 


140 


DPC. 


%RP0'2=j2r 
%CVERS=Jef 


BIN 


1 






DPL. 


140 


DPL. 


%RPi^2=i3^ 
%LVERS=jef 


MS 


6 


DOSSAV 


065 


- 




- 


- 


HRM 


- 


DTC. 


#3 


- 




- 


- 


BIN 


1 


DTCOPY 


010 


- 




- 


- 


BIN 


5 


DTD. 


je)^6 


- 




- 


- 


BIN 


1 


DTE. 


/06 


- 




- 


- 


BIN 


1 


DTF. 


^P 


- 




- 


- 


BIN 


1 


DUMP 


014 


- 




No CLOSE on 


- 


MS 


2 


DYLDR 


pVj^ 


- 




every oper. 

CLOSE on 


UC15=0 


BIN 


3 


EDIT15 


022 


EDIT 


022 


every oper. 

EDIT 


- 


BIN 


5 






EDITVP 


022 


EDITVP 


EDITVP=jZf 


BIN 


5 






EDITVT 


022 


EDITVT 

, . 


EDITVT=0' 


BIN 


5 



Table 1 (Cont.) 
Sources Assembled Under MACRO-15 



Source File 
Name 


Rename 
To 


It 


Desired 

Version 


Assembly 
Parameters 


Type of 
Binary 


Footnote 


EXECUT 


050 


- 




PAGE MODE 


- 


BIN 


4 










BANK MODE 


PDP9=0' 
PDP15=;Zf 


BIN 


4 


FNEW 


004 


- 




- 


- 


BIN 


4 


FOCAL 


025 


- 




PAGE MODE 


- 


BIN 


4 










BANK MODE 


%PDP9=jZf 
%PDP15=0 


BIN 


4 


FORT 


p2 


- 




- 


- 


BIN 


3 


FORTRAN OTS 




- 




- 


- 


- 


8 


F4P1 


<liAQ 


SEE F4P2 


- 


- 


- 


- 


F4P2 


049 


F4 


049 


F4X 


- 


BIN 


8,5 






F4 


049 


FPF4X 


%FPP==0 


BIN 


8,5 






F4 


049 


F4X9 


%PDP9=J2^ 


BIN 


8,5,13 


INSTRC 


m 


- 




- 


- 


BIN 


4 


LKA. 


Pj^J^ 


- 




- 


- 


BIN 


1 


.LOAD 


028 


- 




PAGE MODE 


- 


BIN 


4 






- 




BANK MODE 


PDP9=0 


BIN 


4 


LPA.09 


04 


LP A. 


)ZJ04 


- 




BIN 


1,13 


LPA.IS 


049 


LP A. 


049 


FORM FEED ON 
.CLOSE 


- 


BIN 


1 






LP A. 


049 


NO FORM FEED 
ON .CLOSE 


N0FF=1 


BIN 


1 


LPU, 


)2f2£f 


LP A. 


ji2f!i 


FORM FEED ON 
.INIT, .CLOSE, 
COUNT OF 58 
LINES 




BIN 


1 






LP A. 


^20 


OTHER LINE 
COUNT 


FFCNT=OCTAL 
COUNT 


BIN 


1 






LP A. 


02fi 


AND HANDLER - 
GENERATED FROM 
FEED 


NOFF=^ 


BIN 


1 






LP A. 


JHI20 


UNS POOLED* 
OPERATION 


NOSPL=0' 


BIN 


1 



*If the UNICHANNEL-15 spooler is turned on, this version of the line printer 
handler will rxon unspooled. 



Table 1 (Cont.) 
Sources Assembled Under MACRO-15 



Source File 
Name 


Rename 
To 


It 


Desired 
Version 


Assembly 
Parameters 


Type of 
Binary 


Footnote 


LP. 647 


00. 


LP A. 


0912 


TAB ST0P=8 


- 


BIN 


1,13 






LP A. 


002 


TAB STOP=l;Zl 


TAB1^=/) 


BIN 


1 


LTORPB 

LTX. 

MACIMG 


000 
006 


"■ 




FOR 8K PDP-11 


— 


BIN 

BIN 
BIN 


3 

16 
9 










FOR 4K PDP-11 


LM4K=0' 


BIN 


9 










FOR 12K PDP-11 


LM12K=;e^ 


BIN 


9 


MAC INT 


014 


MACll 


014 


FOR 8K PDP-11 


- 


ABS 


9 










FOR 4K PDP-11 


LM4K=0 


ABS 


9 










FOR 12K PDP-11 


LM12K=0 


ABS 


9 


MACR15 


086 


MACRO 


086 


- 


- 


ABS 


2 


MTA. 


004 






- 


- 


BIN 


1 


MTC. 


)S0jd 


- 




- 


- 


BIN 


1 


MTDUMP 


005 


- 




- 


- 


BIN 


5 


MTF. 


012 


- 




- 




BIN 


1 


NUVAL 


0JdZ) 


- 




- 


- 


BIN 


3 


PATCH 


018 


- 




- 


- 


ABS 


2 


PPA. 


)60l 


- 




- 


- 


BIN 


1 


PPB. 


mi 


- 




- 


- 


BIN 


1 


PPC. 


0JS1 


- 




- 


- 


BIN 


1 


PEA. 


009( 


- 




- 


- 


BIN 


1 


PRB. 


sfm 


- 




- 


- 


BIN 


1 


QFILE 


010 


- 




- 


- 


BIN 


5 



Table 1 (Cont.) 
Sources Assembled Under MACRO-15 



Source File 
Name 



RESMOM 084 



Rename It 
To 



RFBOOT 014 

RKBOOT 014 
RPBOOT 006 



Desired 
Version 



Assembly 
Parameters 



No UC15 

UC15 

UC15 

No LP TCB 

UC15 

No CD TCB 

UC15 

No XY TCB 

UC15 

No spare TCB's 
(Call delete) 

UC15 

No Spare #1 TCB 

UC15 

No Spare #2 TCB 

UC15 

No Spare #3 TCB 



UC15 Option 



UC15 Option 



UC15=0 

UC15=0 
LPTCB=0 

UC15=0 
CDTCB=0 

UC15=0 
XYTCB=0 

UC15=0 
TCB=0 



UC15=0 
TCB 1=0 

UC15=0 
TCB 2=0 

UC15=0 
TCB3=0 



UC15=0 



UC15=0 



Type of 
Binary 



Footnote 



ABS 
ABS 

ABS 



ABS 
.ABS 

ABS 
ABS 

ABS 

HRM 
HRM 
HRM 
HRM 
HRM 



2,6,12,15 
2,6,12,15 

2,6,12,15 



ABS 2,6,12,15 



2,6,12, 15 



2,6,12, 15 



2,6,12, 15 



2,6,12,15 



2,6,12,15 



5a 



Table 1 (Cont.) 
Sources Assembled Under IIACRO-IS 



Source File 
Name 



SGEN 
SGITOLK 



S PL IMG 



SP0L15 



SRCCOM 
SYSBLK 



VTA. 
VTPRIM 
VWA. 
XYU. 



8TRAN 
89TRAN 



045 

020 



002 
023 



011 
013 



.SYSLD 


;353 


TRACK 


003 


UPDATE 


005 


VPA. 


013 



fS^A 



03 
032 



001 
001 



Rename It 
To 



SPOOL 023 



XYA. 
XYA. 



032 
032 



Desired 
Version 



FF SYSTEM 
RK SYSTEM 
RP SYSTEM 



RF SYSTEM 
RK SYSTEM 
RP SYSTEM 



VPA. 

VPA.S 



XYll PLOTTER 

XYll PLOTTER, 

UNSPOOLED 

OPERATION 



Assembly 
Parameters 



Ktg^5=0' 
RPjZf2=j2f 



Type of 
Binary 



SPOLSZ=SIZE OF 
SPOLll PROGRAM 

FB=FIRST BLOCK 
NUMBER OF SPOOL 
PROGRAM 
SPOLSZ=SIZE OF 
SPOLll PROGRAM 



RK!2l'5=0 
RPgi2=0 



VPA. 3=0" 



NOSPL=0 



BIN 
ABS 
ABS 
ABS 
BIN 

ABS 



BIN 
ABS 
ABS 
ABS 
ABS 
BIN 
ABS 
BIN 
BIN 
BIN 
BIN 
BIN 
BIN 
BIN 

BIN 
BIN 



Footnote 



5 

2 

2 

2 

2,5 

3 

1 
1 
1 
3 
1 
1 
1 

5 
5 



Table 2 
Sources Assembled Under MACRO-ll 



Source File 
Name 


Rename It 
To 


Desired 
Version 


Assembly 
Parameters 


Type of 
Binary 


Footnote 


LM4K MAC 




- 


- 


OBJ 


9 


LM8K MAC 


- 


- 


- 


OBJ 


9 


LM12K MAC 


■" 


- 


- 


OBJ 


9 


MACROl MAC 


- 


- 


- 


OBJ 


9 


MACR02 MAC 


- 


- 


- 


OBJ 


9 


MACR03 MAC 


- 


- 


- 


OBJ 


9 


MACROS MAC 


- 


- 


- 


OBJ 


9 


MCIOCH MAC 




- 


- 


OBJ 


9 


MEMSIZ MAC 


- 


- 


- 


OBJ 


9 


PIREX 117 


- 


No Devices 


- 


OBJ 


11 




- 


With CRll 


$CD=20000 


OBJ 


11 




- 


With DECtape 


$DT=0 


OBJ 


11,14 






With LPll/LSll/ 
LVll 


$LP=040000 


OBJ 


11,14 






With LVll 


$LV=0 


OBJ 


11,14 






With XYll Off- 
line switch 


$PL=10000 


OBJ 


11,14 






With XYll No 
Off-line Switcl: 


$PL=10000 
$NOSW=0 


OBJ 


11,14 






With RK05 


$RK=100000 


OBJ 


11 






With XY311 
inches scale 


$PL=010000 
$PL311=0 


OBJ 


11,14 






With XY311 
metric scale 


$PL=010000 

$PL311=0 

$UNIT=0 


OBJ 


11,14 


PST MAC 


- 


- 




OBJ 


9 


SPOLll *23 




With CRll 


$CD=020000 


OBJ 


9 






With LPll/LSll 


$LP=040000 


OBJ 


9 






With XYll 
J 1 


$PL=010000 

1 


OBJ 


9 



''See footnote 9. The * in the file name extension represents several possible characters, 
as explained in the footnote. 



Table 3 
Miscellaneous Sources 



Source File 




Desired 


Special 


Type of 


Footnote 


Name 




Version 


Instructions 


Binary 




CIRCLE 


SRC 


- 


COMPILE WITH 
FORTRAN 


BIN 


3 


INSALL 


0^4 


NO UC15 


RENAME IT TO 
INSALL SRC 


N/A 


4 


INSALL 


U05 


HAVE UC15 


RENAME IT TO 
INSALL SRC 


N/A 


4 


INSERR 


jSj^l 


- 


RENAME IT TO 
INSERR SRC 


N/A 


4 


ROTATE 


SRC 


- 


COMPILE WITH 
FORTRAN 


BIN 


3 


^TECTOR 


SRC 


- 


COMPILE WITH 
FORTRAN 


BIN 


3 



The type of binary produced affects the method by which it is incor- 
porated into an existing system. The last column in each table 
references an explanatory note which describes the method of binary 
installation. 

EXPLANATORY NOTES 

First, the disk system must be restored to the disk using DOSSAV. 
Then, after assembling the code, one of the following steps must 
be performed as indicated in the footnotes to Tables 1, 2, and 3. 

1. Nearly all relocatable binary I/O handlers should be transferred, 
using PIP, to the <IOS> directory, e.g., 

>Tt«, DKi_j< lOS >-f-DKu-i<SCR>i_jCDB .uJ BIN^ 

2, With the exception of a few PDP-11 programs, all programs which 
are to be core image (SYS) files are installed by using the 
PATCH program. The following example is for assembled binaries 
whose file extension is ABS: 



PATCH Vnn 
>CHAINi) 
>READujCHAIN^ 
> 



3. Some relocatable binary routines are kept in the <PER> directory. 
They can be transferred there using PIP, e.g., 

>TujDKi«i<PER>-^DKi»j<SCR>i-jCIRCLEi_iBIN^ 

4, The BANK and PAGE mode versions of these programs should be 
transferred, respectively, to the <BNK> and <PAG> directories 
using PIP with commands similar to those above. Although FNEW 
is not conditionalized, it goes hand in hand with FOCAL. Thus, 
a copy of FNEW BIN should be transferred to both directories. 
INSTRC BIN, INSERR SRC, and INSALL SRC should be transferred to 
both the <BNK> and <PAG> directories using PIP. INSTRC BIN 

is the program which implements the Monitor's $INSTRUCT command 
and INSERR SRC and INSALL SRC are its data files. 



5. With the exception of a few PDP-11 programs, all programs which 
are to be core image (SYS) files are installed by using the 
PATCH program. The following example is for assembled binaries 
whose file extension is BIN: 



PATCH Vnn 
>D0S15^ 

>READRi_jl6077i»jDOS15V 
> 



For the programs in this category, the following numeric argu- 
ments are needed in the READR command: 



PIP 


17600 


D0S15 


16077 


EDIT 


17143 


EDITVP 


17075 


EDITVT 


17122 


MTDUMP 


17600 


QFILE 


17477 


SGEN 


16122 


8TRAN 


17600 


89TRAN 


17600 


DTCOPY 


17600 


F4 


17600 


SRCCOM 


17600 



6. A few programs with ABS file extensions are installed using 
PATCH into programs with dissimilar names. For example. 



PATCH Vnn 
>RESMON^ 
>READi_iSGNBLKy 
> 



The file SGNBLK is patched into RESMON. Files in this category 
are: 

File is Patched into 



5^^* '^^^^f^E I Choose one of the threse as a function 

Df which disk is the system devic 
(DKL. is for the RF15/RSJJ9 Disk) . 



^^^- .SYSLD > Qf which disk is the system device 

DPL. .SYSLD I fTtVT A try -P^-i- *-U^ -D-ci r; /-DO flfQ n-ir-'U\ 

SGNBLK RESMON 



BCDB. RESMON 

There is no conditional assembly required for MACRO-15, It 
determines whether or not to run as the page mode version 
(MACRO-15) or the bank mode version (BMACRO-15) by a dynamic 
test at run time. 



10 



8. Assembly instructions for the FORTRAN OTS routines are given in 
an appendix to the manual PDP-15 FORTRAN IV OPERATING ENVIRONMENT, 
DEC- 15-LFEMA-A-D . 

Assembly of the compiler, because it is in two parts, requires 
a special command string to MACRO-15, e.g., 

>FZ-^F4P1i_j044,F4i_i044^ 

with additional command characters as necessary. After 
assembling the compiler, see note 5. 

9. SPOOL and MACll are PDP-11 programs that exist as PDP-15 system 
programs. Each of these system programs contains some PDP-15 
code at the beginning; this code is the system interface. Both 
these system programs are laid out on the disk as indicated 
below: 



r 



Contiguous 
area of disk 
allocated to 
system program 
by SGEN 




PDP-15 code 



increasing disk 
block #*s 



Space for expansion bug fix 



\ PDP-11 code 



J Space for expansion bug fix 



In order to build the image of both these programs, space on 
the system disk has to be reserved through SGEN, using the 
following information. 



MACll* 



no overlays ^ 2 buffers 

40 blocks (octal) 

-12 and -11 .DAT slots 



*See Appendix on UC15 Options in Unichannel-15 Software Manual 
(DEC-15-XUCMA-A-D) for further details. 



11 



SPOOL no overlays or buffers 
45 blocks (octal) 



After creating the system programs via SGEN the images can 
be built as follows: 



MACll: a. Assemble MACIMG 0J2I6 using MACRO-15 to 
produce MACIMG BIN. 

b. Assemble the different pieces of MACll, 
as indicated below, using MACRO-11 under 
DOS-11 (a step which cannot be done by 
the PDP-15 customer) . 



#MCUCX,[lP : /CR^<LM8K,MEMSIZ ,MACR01, 
MCI0CH,MACR02j 

if a CREF listing is required, 
otherwise null string 

# MCUCA,^ :/CR§<LM8K,MEMSIZ , MACRO 1, 

MC lOCH , MACRO 3 , MACRO 5 J 

The above 2 assemblers will produce the 
object modules MCUCX.OBJ and MCUCA.OBJ 
for an 8K UC15 system. For 4K and 12K 
UC15 systems use LM4K and LM12K respectively 
instead of LM8K. 

#MCUPST,LP:/CRF<LM8K,PST^ 

c. To produce the load module of MACll on 
papertape the above 3 object modules 
have to be linked by the DOS-11 linker 
(not available to PDP-15 customers), i.e., 

#PP:MCUC15/SQ,|LPp<MCUCX,MCUCA,MCUPST/B:0/E 
for a load map 

d. GLOAD on DOS- 15 (load and execute) MACIMG 
BIN after loading the MACll object module 
on the high speed paper tape reader and is- 
suing API OFF. A 'DONE' message is printed 
on the console when the image of MACll has 
been successfuly built on the disk in the 
area reserved by SGEN. MACIMG performs its 
own I/O; hence, it does not require assign- 
ments to .DAT slots. 

e. Rename MACINT 014 to MACll 014, assemble 
with MACRO-15 and then use PATCH as shown 
in note 2, to install it into MACll. 
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SPOOL: a. Assemble SPOLll *28 under MACll to produce 
the SPOLil load module on papertape. The * 
in the file name extension can be any of the 
following, which indicate which assembly 
parameters are defined internally in the 
source code. To change assembly parameters 
one must edit the source file. 

* = 1 for null task 

= A for LPll/LSll task only 

= B for CRll task only 

= C for LPll/LSll and CRll tasks only 

= D for XYll task only 

= E for LPll/LSll and XYll tasks only 

= F for XYll and CRll tasks only 

= G for LPll/LSll, XYll and CRll 
tasks only 

For example, 

SPOLll C22 should be the name of the source 
file when the spooled devices are to be 
LPll/LSll and the CRll. 

b. Assemble SPLIMG 002 under MACRO- 15. 

c. Issue an API OFF command to DOS then, 
GLOAD SPLIMG BIN after loading the SPOLll 
object module in the high speed paper tape 
reader. A "DONE" message is printed on the 
console when the image of SPOL 11 has been 
successfully built on the disk. 

d. Rename SP0L15 023 to SPOOL J2f23, assemble 
with MACRO- 15 and then use PATCH, as shown 
in note 2, to install it into SPOOL. 

10. The ABSLll loader cannot be assembled with the version of MACRO-15 
supplied to customers. It requires a special version of MACRO-15, 
called MACRO-D, used to generate PDP-15 Diagnostic programs. The 
difference is in the load addresses for HRM tapes: 17720 for 
MACRO-15 and 17700 for MACRO-D. 

11. PIREX is conditionalized so that code for only existing devices 
need be assembled. The output from MACll to paper tape is an 
absolute binary object module which is loaded into the PDP-11 
by the ABSLll loader as described in the Unichannel-15 Software 
Manual, (DEC-15-XUCMA-A-D) . The conditionalization for DECtape 
and LVll is listed for the user's convenience. These devices 
are not software supported by DEC. 

12. DOSBCD, the batch card reader handler, is part of the resident 
monitor. The position in core memory occupied by DOSBCD depends 
upon the size of the resident monitor (RESMON) . Thus the 
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start address of DOSBCD, BCDSTA, is a variable which can be defined 
as an assembly parameter. Also, certain addresses in DOSBCD must 
be supplied to RESMON at a specific address, BCDADP, to insure 
proper operation. Both parameters are defined from values obtained 
from an assembly listing of RESMON. The value to be assigned to 
BCDSTA should be the same as the value of the parameter CD, defined 
by the line CD=., in RESMON. The value for BCDADR should be set 
equal to the location one higher than the address tap DATLl in 
RESMON. 

For RESMON 00A these values are: 





NO UC15 


HAVE UC15 


BCDSTA 


6463 


7572 


BCDADR 


11726 


13041 



13. The steps taken to produce the DOS-15 tapes distributed by DEC 
vary from those outlined in the tables in a few cases: 

a. The F4X9 version of the FORTRAN compiler was made by 
renaming the source file F4P2 j2f49 to F4X9 049, rather 
than to F4 J2f49 as shown in Table 1. The resulting 
binary file after assembly is F4X9 BIN rather than 
F4 BIN. This was done so that this particular version 
of the compiler could readily be identified in the 
disk's <PER> UFD. The code produced either way is 
identical. 



b. The LP09 line printer handler was not renamed to LPA. 
00A, as indicated in Table 1, so that the binary file 
in the disk's <PER> UFD can be identified as LPA. 09 
BIN. 



c. The 647 line printer handler was not renamed to LPA. 
002, as indicated in Table 1, so that the binary file 
in the disk's <PER> UFD can be identified as LP. 647 BIN, 



14 



14. OFFLINE SWITCH 

The CALCOMP plotter does not have an offline switch. This 
leads to difficulty in stopping the plotter to refill pen, 
take off plots, etc. Bit 2 switch of the PDP-11 console 
switches is to be used as the offline switch for the CALCOMP. 
If you do NOT wish this feature define $NOSW=0. 

Note, for $PL311, this is automatically disabled, do not 
define 1 1 

Conditional Assembly for XYll or XY311 Plotter Interface 
$PL311 if defined will generate the control bytes required 
for CALCOMP 's 936. If undefined, the control bytes for 
CALCOMP 's 500 series are generated. If $PL311 is defined 
then the units for the plotter step size should be speci- 
fied. $UNITS defined generates a metric plotter. Unde- 
fined gives one in inches, 

15. The UC15 version of the RESMON contains six special buf- 
fers utilized as PIREX/DOS TCB's. These buffers are 
utilized as follows: 

1. A 117 word Line Printer TCB. 

2. A 65 word Card Reader TCB. 

3. A 117 word Plotter TCB. 

4. A 24 word Spare TCB. 

5. A 120 word Spare TCB. 

6. A 170 word Spare TCB. 

The spare TCB's are available for the use of customer 
programs desiring communication with PIREX, 

If any of these TCB's are not needed - they can be deleted 
by utilizing the appropriate assembly parameter. 

16. LTX. is a dummy handler. See the SGEN-DOS UTILITY PROGRAM MANUAL 

(DEC-15-USGNA-A-D) for more details about the use of LTX. 
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HOW TO OBTAIN SOFTWARE INFORMATION 

SOFTWARE NEWSLETTERS, MAILING LIST 

The Software Communications Group, located at corporate headquarters in 
Maynard, publishes newsletters and Software Performance Summaries (SPS) 
for the various Digital products. Newsletters are published monthly, 
and contain announcements of new and revised software, programming 
notes, software problems and solutions, and documentation corrections. 
Software Performance Summaries are a collection of existing problems 
and solutions for a given software system, and are published periodi- 
cally. For information on the distribution of these documents and how 
to get on the software newsletter mailing list, write to: 

Software Communications 

P. 0. Box F 

Maynard, Massachusetts 01754 

SOFTWARE PROBLEMS 

Questions or problems relating to Digital's software should be reported 
to a Software Support Specialist. A specialist is located in each 
Digital Sales Office in the United States. In Europe, software problem 
reporting centers are in the following cities. 

Reading, England Milan, Italy 

Paris, France Solna, Sweden 

The Hague, Holland Geneva, Switzerland 

Tel Aviv, Israel Munich, West Germany 

Software Problem Report (SPR) forms are available from the specialists 
or from the Software Distribution Centers cited below. 

PROGRAMS AND MANUALS 

Software and manuals should be ordered by title and order number. In 
the United States, send orders to the nearest distribution center. 

Digital Equipment Corporation Digital Equipment Corporation 

Software Distribution Center Software Distribution Center 

146 Main Street 1400 Terra Bella 

Maynard, Massachusetts 01754 Mountain View, California 94043 

Outside of the United States, orders should be directed to the nearest 
Digital Field Sales Office or representative. 

USERS SOCIETY 

DECUS, Llgital Equipment Computer Users Society, maintains a user ex- 
change center for user-written programs and technical application in- 
formation. A catalog of existing programs is available. The society 
publishes a periodical, DECUSCOPE, and holds technical seminars in the 
United States, Canada, Europe, and Australia. For information on the 
society and membership application forms, write to: 

DECUS DECUS 

Digital Equipment Corporation Digital Equipment, S.A. 
146 Main Street 81 Route de I'Aire 

Maynard, Massachusetts 01754 1211 Geneva 26 

Switzerland 



DOS-15 ASSEMBLY PARAMETERS 
DEC-15-0DAPA-A-D 

READER'S COMMENTS 

NOTE: This form is for document comjnents only. Problems 
with software should be reported on a Software 
Problem Report (SPR) form (see the HOW TO OBTAIN 
SOFTWARE INFORMATION page) . 

Did you find errors in this manual? If so, specify by page. 



Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 



Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 



Please indicate the type of user/reader that you most nearly represent. 

r~] Assembly language programmer 

I I Higher-level language programmer 

I I Occasional programmer (experienced) 

I I User with little programming experience 

I I Student programmer 

I I Non-programmer interested in computer concepts and capabilities 

Name_ Date 

Organization 

Street 



City. State zip Code 

or 
Country 

If you do not require a written reply, please check here. f"] 



Fold Here 



Do Not Tear - Fold Here and Staple 



BUSINESS REPLY MAIL 

NO POSTAGE STAMP NECESSARY IF MAILED IN THE UNITED STATES 



Postage will be paid by: 
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Software Communications 

P. 0. Box F 

Maynard, Massachusetts 01754 
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